Skip to content

feat: add Homebrew formula and cask for distribution#329

Closed
Dumbris wants to merge 1 commit intomainfrom
worktree-agent-a852764a
Closed

feat: add Homebrew formula and cask for distribution#329
Dumbris wants to merge 1 commit intomainfrom
worktree-agent-a852764a

Conversation

@Dumbris
Copy link
Member

@Dumbris Dumbris commented Mar 10, 2026

Summary

  • Add Homebrew Formula (homebrew/Formula/mcpproxy.rb) for CLI-only installation via brew install
  • Add Homebrew Cask (homebrew/Casks/mcpproxy.rb) for tray app installation via brew install --cask
  • Add homebrew/update-formula.sh automation script for release updates
  • Add homebrew/README.md with tap setup and homebrew-core submission guide

Details

  • Formula builds from source using go + node dependencies, includes brew services support
  • Cask downloads signed/notarized DMGs from GitHub Releases (arm64 + amd64)
  • Real SHA256 hashes from v0.20.2 release artifacts
  • Follows Tailscale/Docker pattern: Formula for CLI, Cask for GUI app
  • Ready for smart-mcp-proxy/homebrew-mcpproxy tap and eventual homebrew-core submission (155 stars > 75 threshold)

Test plan

  • Verify formula Ruby syntax passes brew audit
  • Verify cask Ruby syntax passes brew audit
  • Test brew install from local tap
  • Test brew install --cask from local tap
  • Copy files to homebrew-mcpproxy repo and test end-to-end

🤖 Generated with Claude Code

Add Homebrew distribution files for MCPProxy:
- Formula (homebrew/Formula/mcpproxy.rb): builds CLI from source with Go + Node.js,
  embeds frontend web UI, includes service block and test block
- Cask (homebrew/Casks/mcpproxy.rb): installs signed/notarized tray app DMG with
  PKG installer, supports both arm64 and amd64
- Update script (homebrew/update-formula.sh): automates version bumps by downloading
  assets and computing SHA256 hashes
- README with tap setup instructions and homebrew-core/homebrew-cask submission guide

All SHA256 hashes are computed from real v0.20.2 release assets.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@cloudflare-workers-and-pages
Copy link

Deploying mcpproxy-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: f5905ed
Status: ✅  Deploy successful!
Preview URL: https://2be85450.mcpproxy-docs.pages.dev
Branch Preview URL: https://worktree-agent-a852764a.mcpproxy-docs.pages.dev

View logs

@github-actions
Copy link

📦 Build Artifacts

Workflow Run: View Run
Branch: worktree-agent-a852764a

Available Artifacts

  • archive-darwin-amd64 (24 MB)
  • archive-darwin-arm64 (21 MB)
  • archive-linux-amd64 (13 MB)
  • archive-linux-arm64 (11 MB)
  • archive-windows-amd64 (23 MB)
  • archive-windows-arm64 (21 MB)
  • frontend-dist-pr (0 MB)
  • installer-dmg-darwin-amd64 (26 MB)
  • installer-dmg-darwin-arm64 (24 MB)

How to Download

Option 1: GitHub Web UI (easiest)

  1. Go to the workflow run page linked above
  2. Scroll to the bottom "Artifacts" section
  3. Click on the artifact you want to download

Option 2: GitHub CLI

gh run download 22897271117 --repo smart-mcp-proxy/mcpproxy-go

Note: Artifacts expire in 14 days.

@Dumbris
Copy link
Member Author

Dumbris commented Mar 10, 2026

Closing — formula/cask files should live only in the tap repo (smart-mcp-proxy/homebrew-mcpproxy), not in the main project repo. This is universal standard practice (gh, lazygit, tailscale, etc. all do it this way). Will push these files to the tap repo instead.

@Dumbris Dumbris closed this Mar 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants